package com.quectel.core.module.dept.service;


import com.quectel.core.module.dept.dto.DeptDto;

import java.util.List;
import java.util.Map;

/**
 * @author caolu
 * @email louis.cao@quectel.com
 * @date 2022/03/24 10:07
 */
public interface DeptService {
    /**
     * 更新或者删除
     *
     * @param deptDto
     */
    void saveOrUpdate(DeptDto deptDto);

    /**
     * 根据父亲查询下属元素
     *
     * @param id
     * @return
     */
    List<DeptDto> selectByParentId(Long id);

    /**
     * 按名称查询
     *
     * @param villageId
     * @param name
     * @return
     */
    DeptDto selectByName(Long villageId, String name);

    /**
     * 按编码查询
     *
     * @param villageId
     * @param code
     * @return
     */
    DeptDto selectByCode(Long villageId, String code);


    /**
     * 根据部门id，递归查询所有下级部门，包含自身
     *
     * @param deptId
     * @return
     */
    List<DeptDto> queryByRecursion(Long deptId);

    /**
     * 根据id查询一条记录 有缓存默认五分钟
     *
     * @param id
     * @return
     */
    DeptDto selectCacheById(Long id);

    /**
     * 根据id查询一条记录
     *
     * @param id
     * @return
     */
    DeptDto selectById(Long id);

    /**
     * 查询列表
     *
     * @param params
     * @return
     */
    List<DeptDto> queryList(Map<String, Object> params);

    /**
     * 查询数量
     *
     * @param params
     * @return
     */
    int queryTotal(Map<String, Object> params);

    /**
     * 存入一条记录
     *
     * @param dto
     * @return 存入数据的id
     */
    Long save(DeptDto dto);

    /**
     * 根据id更新一条记录 字段为null不更新
     *
     * @param dto
     */
    void updateById(DeptDto dto);

    /**
     * 根据id更新一条记录  字段为null会更新 建议先查询再更新
     *
     * @param dto
     */
    void updateAllColumnById(DeptDto dto);

    /**
     * 根据id删除一条记录
     *
     * @param id
     */
    void deleteById(Long id);

    /**
     * 批量删除
     *
     * @param ids
     */
    void deleteBatch(Long[] ids);


}
